百度地图服务生态

酒店试单请求 | 百度->商户

更新时间：2023-06-20

酒店试单请求【百度即时请求商户】

功能

查询用户当前预定房型是否为可预定状态，场景：用户进入填单页之前，会通过此接口到直连商家确认产品是否可售；

权限说明

为确保对内外请求安全性，添加公共参数并对公共参数进行统一验签，对于百度请求商户，百度在请求参数中添加以下公共参数，对于商户数据推送百度，在推送json数据体最外层key中也添加以下公共参数（详细见各推送数据样例）。

字段名 类型 长度 必填 释义
1 tp_name string 64 是 渠道号，开发前分配渠道号和私（primary_key），请妥善保管
2 timestamp int 10 是 秒时间戳
3 salt string 64 是 随机串
4 sign string 64 是 签名，签名规则 md5(tp_name + timestamp + salt + primary_key)，单纯参数值（不含参数名）拼接，不需要加入参数名
注意事项

1.last_cancel_time字段格式：yyyy-mm-dd hh:ii:ss 例：2021-09-01 00:00:00;

2.当cancel_policy为3(不可取消)时，字段cancel_cut_type,cancel_cut_value为0，last_cancel_time为"";

3.错误码按照文档返回

请求参数

字段名 类型 长度 必填 释义
1 tid string 64 是 酒店id
2 start string 64 是 起始时间 例：2021-09-01 00:00:00
3 end string 64 是 截止时间 例：2021-09-03 00:00:00
4 room_type_id string 64 是 物理房型id
5 activity_id string 64 是 价格计划id
6 room_count int - 是 房间数
7 pay_amount int - 是 支付金额 单位：分
8 bd_mmc_ext string 64 否 扩展字段json，扩展字段
9 gift_id string 64 否 酒套ID，用户选择的优惠信息
10 公共参数 - - 是 公共参数参考公共参数部分

响应参数

字段名称 字段要求 字段类型 是否必须 字段说明
1 errno 11：表示满房（请求日期段库存为0，不可预定）12：价格计划id失效13：房量不足（请求日期端库存不全部为0，部分可售）14：其他不可预定（发生异常等） string 是 错误码
2 errstr 11：表示满房12：价格计划id失效13：房量不足14：其他不可预定 是 错误描述
3 desc - string 是 描述
4 price_models 详见返回示例 string 是 请求时间内价格库存日历

请求示例

GET {Host}/{path}?tid=220285&start=2022-04-06&end=2022-04-07&room_type_id=xxxx&activity_id=xxxxx&room_count=1&pay_amount=xxxxx&bd_mmc_ext=&tp_name=xxx&timestamp=1649241929&salt=624d6f4974bea&sign=5ad23df928c94010d23a536516da242e&gift_id=m12sk

响应示例

(注:同一房型价格计划下返回的price_models必须同酒店房型房价抓取接口中price_models对应日期的数据信息保持一致)

成功

{
	"errno": 0,
	"errstr": "",
	"desc": "",
	"data": {
		"price_models": [
			{
				"date": "2021-09-02",
				"last_cancel_time": "2021-09-02 11:00:00",
                "cancel_cut_type": 0,
				"cancel_cut_value": 0,
				"stock_count": 2,
				"market_price": 5000,
				"tp_discount_price": 4800,
				"vip_price": 0,
				"discount_value": 200,
				"breakfast": 1
			},
			{
				"date": "2021-09-03",
				"last_cancel_time": "2021-09-02 11:00:00",
                "cancel_cut_type": 0,
				"cancel_cut_value": 0,
				"stock_count": 2,
				"market_price": 5000,
				"tp_discount_price": 4800,
				"vip_price": 0,
				"discount_value": 200,
				"breakfast": 1
			},
			{
				"date": "2021-09-04",
				"last_cancel_time": "2021-09-02 11:00:00",
                "cancel_cut_type": 0,
				"cancel_cut_value": 0,
				"stock_count": 2,
				"market_price": 5000,
				"tp_discount_price": 4800,
				"vip_price": 0,
				"discount_value": 200,
				"breakfast": 1
			}
		]
	}
}

失败

{
  "errno": 13,
  "errstr": "房量不足",
  "desc": "房量不足",
  "data": {}
}
钟点房说明

钟点房响应增加字段hour_room_info(参考酒店房型房价抓取中相应字段规则)

字段名 类型 长度 必填 释义
1 is_hour_room int 64 是 是否为钟点房
2 can_checkin_start string - 是 入住时间
3 can_checkin_end string - 是 离店时间
4 hourage int 64 是 入住时长

样例：

{
	"errno": 0,
	"errstr": "",
	"desc": "",
	"data": {
		"price_models": [{
			"date": "2023-06-16",
			"last_cancel_time": "2023-06-16 11:00:00",
			"cancel_cut_type": 0,
			"cancel_cut_value": 0,
			"stock_count": 2,
			"market_price": 5000,
			"tp_discount_price": 4800,
			"vip_price": 0,
			"discount_value": 200,
			"breakfast": 1,
			"is_hour_room": "T",
			"hour_room_info": {
				"can_checkin_start": "10:00",
				"can_checkin_end": "20:00",
				"hourage": 4
			}
		}]
	}
}
酒店基础数据自营填单 | 百度->商户